home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 April / EnigmA AMIGA RUN 06 (1996)(G.R. Edizioni)(IT)[!][issue 1996-04][Skylink CD V].iso / earcd / utilgfx / nwpltt12.lha / NewPalette.doc < prev   
Text File  |  1996-01-27  |  4KB  |  108 lines
  1. Short:    Replace palette in IFF ILBM with another
  2. Uploader: troels@stud.cs.uit.no (Troels Walsted Hansen)
  3. Author:   troels@stud.cs.uit.no (Troels Walsted Hansen)
  4. Type:     util/cli
  5.  
  6.      _   _               ____       _      _   _
  7.     | \ | | _____      _|  _ \ __ _| | ___| |_| |_ ___
  8.     |  \| |/ _ \ \ /\ / / |_) / _` | |/ _ \ __| __/ _ \
  9.     | |\  |  __/\ V  V /|  __/ (_| | |  __/ |_| ||  __/
  10.     |_| \_|\___| \_/\_/ |_|   \__,_|_|\___|\__|\__\___| v1.2
  11.  
  12. Introduction
  13. ¯¯¯¯¯¯¯¯¯¯¯¯
  14. I wrote this little utility because I couldn't find one on AmiNet that would
  15. do exactly what I wanted it to.  This program will basically read two IFF
  16. ILBM files and write a new one containing the palette from one of the two
  17. source files, and everything but the palette from the other.
  18.  
  19. I use it in conjunction with the ArcsPack series of backdrops found on
  20. AmiNet.  All the pictures in that series are drawn with a palette that is
  21. arranged the same.  The palette can be interchanged with any one of a number
  22. of supplied palettes.  This is a pain to do in an image manipulation package,
  23. but with NewPalette it is a breeze. :-)
  24.  
  25. Features
  26. ¯¯¯¯¯¯¯¯
  27.  · Standard Amiga patternmatching makes it easy to change the palettes of
  28.    many pictures
  29.  
  30.  · Random option picks a random palette from any number of palettes specified
  31.    with standard patterns. This allows endless variation of your backdrops. :-)
  32.  
  33. Requirements
  34. ¯¯¯¯¯¯¯¯¯¯¯¯
  35.  · AmigaOS 2.04 or higher
  36.  
  37. Usage
  38. ¯¯¯¯¯
  39. NewPalette can only be used from the Shell.  It takes a number of arguments,
  40. out of which only two are mandatory.  These are the first two, called FROM
  41. and PALETTE.  FROM can be a path and a filename or a path and a pattern.  If
  42. you don't specify RANDOM, then the PALETTE argument must be a filename.  When
  43. RANDOM is specified PALETTE can be a path and a pattern and the palette for
  44. each picture will be picked from all files that match this pattern.  DESTDIR
  45. (may be abbreviated DEST) is an optional keyword and may specify a path where
  46. to place the new pictures that NewPalette writes.  EXTENSION (abbriviation
  47. EXT) is also an optional keyword, this one tells NewPalette to add the
  48. extension specified, to the filename of the new pictures.
  49.  
  50. The AmigaDOS template looks like this:
  51.    FROM/A,PALETTE/A,RANDOMS,DESTDIR=DEST/K,EXTENSION=EXT/K
  52.  
  53. Example usage
  54. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  55. NewPalette ram:pics/#? ram:palette.iff
  56.  · Give all pictures in ram:pics the palette contained in ram:palette.iff.
  57.    The new pictures are written over the old pictures.
  58.  
  59. NewPalette ram:pics/#? ram:palette.iff dest=ram: ext=.new
  60.  · As above except the new pictures are written to ram: with the original
  61.    filename plus the extension ".new".
  62.  
  63. NewPalette ram:pics/T#? ram:pals/#? random
  64.  · All pictures in ram:pics whose name begins with a T gets a random palette
  65.    picked from all the palettefiles found in ram:pals.
  66.  
  67. Author
  68. ¯¯¯¯¯¯
  69. Troels Walsted Hansen <troels@stud.cs.uit.no>, Troels on IRC #Amiga/#Norge
  70.  
  71. Please report all bugs and/or enforcer hits you may find.
  72.  
  73. Legal issues
  74. ¯¯¯¯¯¯¯¯¯¯¯¯
  75. I assume no responsibily for what this program does to you, your computer or
  76. your files, use it at your own risk.  NewPalette is copyright by Troels
  77. Walsted Hansen, but you are allowed to distribute it freely.  Please keep
  78. this doc file along with the program!
  79.  
  80. Thanks to
  81. ¯¯¯¯¯¯¯¯¯
  82. Bowie J. Poag (Arctangent)
  83.  · Your social intelligence is critically low, but your pictures are cool :^)
  84.  
  85. Christopher Naas
  86.  · For giving me the random routine used.
  87.  
  88. Bjørnar Henden
  89.  · For actually writing the random routine. :-)
  90.  
  91. Petter Nilsen, Kjell Irgens and Børge Nøst
  92.  · For answering various programming questions, thanks especially to Petter
  93.    for lending me his RKM books. :-)
  94.  
  95. History
  96. ¯¯¯¯¯¯¯
  97. v1.0:
  98.  · First limited release
  99.  
  100. v1.1 (05.01.96):
  101.  · Patternmatching
  102.  · Extension adding
  103.  · Second limited release
  104.  
  105. v1.2 (27.01.96):
  106.  · Random palette picking
  107.  · First AmiNet release
  108.